FHIR © HL7.org  |  Server Home  |  FHIR Server FHIR Server 3.4.11  |  FHIR Version n/a  User: [n/a]

Resource OperationDefinition/FHIR Server from package hl7.fhir.us.ecr#current (46 ms)

Package hl7.fhir.us.ecr
Type OperationDefinition
Id Id
FHIR Version R4
Source http://hl7.org/fhir/us/ecr/https://build.fhir.org/ig/HL7/case-reporting/OperationDefinition-operationdefinition-library-package.html
Url http://hl7.org/fhir/us/ecr/OperationDefinition/operationdefinition-library-package
Version 2.1.2
Status draft
Date 2021-07-26T09:29:23+11:00
Name LibraryPackaging
Title Library Packaging
Experimental False
Realm us
Authority hl7
Description Packages the contents referenced by an asset-collection library such as a quality program release or version manifest.
Type true
Kind operation

Resources that use this resource

No resources found


Resources that this resource uses

No resources found



Narrative

Note: links and images are rebased to the (stated) source

LibraryPackaging

OPERATION: LibraryPackaging

The official URL for this operation definition is:

http://hl7.org/fhir/us/ecr/OperationDefinition/library-package

Packages the contents referenced by an asset-collection library such as a quality program release or version manifest.

URL: [base]/Library/$package

URL: [base]/Library/[id]/$package

Parameters

Use Name Cardinality Type Binding Documentation
IN id 0..1 string

The logical id of the library to package. The server must know the library (e.g. it is defined explicitly in the server's libraries)

IN url 0..1 uri

A canonical reference to a library. The server must know the library (e.g. it is defined explicitly in the server's libraries)

IN version 0..1 string

The version of the library to be used for packaging

IN identifier 0..1 string
( token)

A business identifier of the library to be packaged. The server must know the library and the identifier must resolve unambiguously to a single library on the server.

IN capability 0..* string

A desired capability of the resulting package. computable to include computable elements in packaged content, executable to include executable elements in packaged content, publishable to include publishable elements in packaged content.

IN offset 0..1 integer

Paging support - where to start if a subset is desired (default = 0). Offset is number of records (not number of pages)

IN count 0..1 integer

Paging support - how many resources should be provided in a partial page view. If count = 0, the client is asking how large the package is.

IN system-version 0..* canonical

Specifies a version to use for a system, if the library or value set does not already specify which one to use. The format is the same as a canonical URL: [system]|[version] - e.g. http://loinc.org|2.56

IN check-system-version 0..* canonical

Edge Case: Specifies a version to use for a system. If a library or value set specifies a different version, an error is returned instead of the package. The format is the same as a canonical URL: [system]|[version] - e.g. http://loinc.org|2.56

IN force-system-version 0..* canonical

Edge Case: Specifies a version to use for a system. This parameter overrides any specified version in the library and value sets (and any it depends on). The format is the same as a canonical URL: [system]|[version] - e.g. http://loinc.org|2.56. Note that this has obvious safety issues, in that it may result in a value set expansion giving a different list of codes that is both wrong and unsafe, and implementers should only use this capability reluctantly. It primarily exists to deal with situations where specifications have fallen into decay as time passes. If the value is override, the version used SHALL explicitly be represented in the expansion parameters

IN manifest 0..1 canonical

Specifies an asset-collection library that defines version bindings for code systems referenced by the value set(s) being expanded. When specified, code systems identified as depends-on related artifacts in the library have the same meaning as specifying that code system version in the system-version parameter.

IN include-dependencies 0..1 boolean

Specifies whether to include known (i.e. present on the server) dependencies of the library in the resulting package, recursively (default = true)

IN include-components 0..1 boolean

Specifies whether to include known (i.e. present on the server) components of the library in the resulting package, recursively (default = true)

OUT return 1..1 Bundle

The result of the packaging. Servers generating packages SHALL include all the dependency resources referenced by the library that are known to the server (if include-dependencies is true), and all the component resources referenced by the library that are known to the server (if include-components is true). For example, a measure repository SHALL include all the required library resources, but would not necessarily have the ValueSet resources referenced by the measure.

This operation is used to retrieve the contents associated with a particular library such as a quality program, including the use of the quality program as a binding parameters specification to identify code system and value set versions that should be used for expansion of value sets used by measures in the quality program.


Source

{
  "resourceType" : "OperationDefinition",
  "id" : "operationdefinition-library-package",
  "text" : {
    "status" : "extensions",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\">\n <h2>LibraryPackaging</h2>\n <p>OPERATION: LibraryPackaging</p>\n <p>The official URL for this operation definition is: </p>\n <pre>http://hl7.org/fhir/us/ecr/OperationDefinition/library-package</pre>\n <div>\n <p>Packages the contents referenced by an asset-collection library such as a quality program release or version manifest.</p>\n </div>\n <p>URL: [base]/Library/$package</p>\n <p>URL: [base]/Library/[id]/$package</p>\n <p>Parameters</p>\n <table class=\"grid\">\n <tr>\n <td>\n <b>Use</b>\n </td>\n <td>\n <b>Name</b>\n </td>\n <td>\n <b>Cardinality</b>\n </td>\n <td>\n <b>Type</b>\n </td>\n <td>\n <b>Binding</b>\n </td>\n <td>\n <b>Documentation</b>\n </td>\n </tr>\n <tr>\n <td>IN</td>\n <td>id</td>\n <td>0..1</td>\n <td>\n <a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a>\n </td>\n <td/>\n <td>\n <div>\n <p>The logical id of the library to package. The server must know the library (e.g. it is defined explicitly in the server's libraries)</p>\n </div>\n </td>\n </tr>\n <tr>\n <td>IN</td>\n <td>url</td>\n <td>0..1</td>\n <td>\n <a href=\"http://hl7.org/fhir/R4/datatypes.html#uri\">uri</a>\n </td>\n <td/>\n <td>\n <div>\n <p>A canonical reference to a library. The server must know the library (e.g. it is defined explicitly in the server's libraries)</p>\n </div>\n </td>\n </tr>\n <tr>\n <td>IN</td>\n <td>version</td>\n <td>0..1</td>\n <td>\n <a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a>\n </td>\n <td/>\n <td>\n <div>\n <p>The version of the library to be used for packaging</p>\n </div>\n </td>\n </tr>\n <tr>\n <td>IN</td>\n <td>identifier</td>\n <td>0..1</td>\n <td>\n <a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a>\n <br/>( <a href=\"http://hl7.org/fhir/R4/search.html#token\">token</a>) </td>\n <td/>\n <td>\n <div>\n <p>A business identifier of the library to be packaged. The server must know the library and the identifier must resolve unambiguously to a single library on the server.</p>\n </div>\n </td>\n </tr>\n <tr>\n <td>IN</td>\n <td>capability</td>\n <td>0..*</td>\n <td>\n <a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a>\n </td>\n <td/>\n <td>\n <div>\n <p>A desired capability of the resulting package. <code>computable</code> to include computable elements in packaged content, <code>executable</code> to include executable elements\n in packaged content, <code>publishable</code> to include publishable elements in packaged content. </p>\n </div>\n </td>\n </tr>\n <tr>\n <td>IN</td>\n <td>offset</td>\n <td>0..1</td>\n <td>\n <a href=\"http://hl7.org/fhir/R4/datatypes.html#integer\">integer</a>\n </td>\n <td/>\n <td>\n <div>\n <p>Paging support - where to start if a subset is desired (default = 0). Offset is number of records (not number of pages)</p>\n </div>\n </td>\n </tr>\n <tr>\n <td>IN</td>\n <td>count</td>\n <td>0..1</td>\n <td>\n <a href=\"http://hl7.org/fhir/R4/datatypes.html#integer\">integer</a>\n </td>\n <td/>\n <td>\n <div>\n <p>Paging support - how many resources should be provided in a partial page view. If count = 0, the client is asking how large the package is.</p>\n </div>\n </td>\n </tr>\n <tr>\n <td>IN</td>\n <td>system-version</td>\n <td>0..*</td>\n <td>\n <a href=\"http://hl7.org/fhir/R4/datatypes.html#canonical\">canonical</a>\n </td>\n <td/>\n <td>\n <div>\n <p>Specifies a version to use for a system, if the library or value set does not already specify which one to use. The format is the same as a canonical URL: [system]|[version] -\n e.g. http://loinc.org|2.56</p>\n </div>\n </td>\n </tr>\n <tr>\n <td>IN</td>\n <td>check-system-version</td>\n <td>0..*</td>\n <td>\n <a href=\"http://hl7.org/fhir/R4/datatypes.html#canonical\">canonical</a>\n </td>\n <td/>\n <td>\n <div>\n <p>Edge Case: Specifies a version to use for a system. If a library or value set specifies a different version, an error is returned instead of the package. The format is the same as\n a canonical URL: [system]|[version] - e.g. http://loinc.org|2.56</p>\n </div>\n </td>\n </tr>\n <tr>\n <td>IN</td>\n <td>force-system-version</td>\n <td>0..*</td>\n <td>\n <a href=\"http://hl7.org/fhir/R4/datatypes.html#canonical\">canonical</a>\n </td>\n <td/>\n <td>\n <div>\n <p>Edge Case: Specifies a version to use for a system. This parameter overrides any specified version in the library and value sets (and any it depends on). The format is the same as\n a canonical URL: [system]|[version] - e.g. http://loinc.org|2.56. Note that this has obvious safety issues, in that it may result in a value set expansion giving a different list\n of codes that is both wrong and unsafe, and implementers should only use this capability reluctantly. It primarily exists to deal with situations where specifications have fallen\n into decay as time passes. If the value is override, the version used SHALL explicitly be represented in the expansion parameters</p>\n </div>\n </td>\n </tr>\n <tr>\n <td>IN</td>\n <td>manifest</td>\n <td>0..1</td>\n <td>\n <a href=\"http://hl7.org/fhir/R4/datatypes.html#canonical\">canonical</a>\n </td>\n <td/>\n <td>\n <div>\n <p>Specifies an asset-collection library that defines version bindings for code systems referenced by the value set(s) being expanded. When specified, code systems identified as\n <code>depends-on</code> related artifacts in the library have the same meaning as specifying that code system version in the <code>system-version</code> parameter. </p>\n </div>\n </td>\n </tr>\n <tr>\n <td>IN</td>\n <td>include-dependencies</td>\n <td>0..1</td>\n <td>\n <a href=\"http://hl7.org/fhir/R4/datatypes.html#boolean\">boolean</a>\n </td>\n <td/>\n <td>\n <div>\n <p>Specifies whether to include known (i.e. present on the server) dependencies of the library in the resulting package, recursively (default = true)</p>\n </div>\n </td>\n </tr>\n <tr>\n <td>IN</td>\n <td>include-components</td>\n <td>0..1</td>\n <td>\n <a href=\"http://hl7.org/fhir/R4/datatypes.html#boolean\">boolean</a>\n </td>\n <td/>\n <td>\n <div>\n <p>Specifies whether to include known (i.e. present on the server) components of the library in the resulting package, recursively (default = true)</p>\n </div>\n </td>\n </tr>\n <tr>\n <td>OUT</td>\n <td>return</td>\n <td>1..1</td>\n <td>\n <a href=\"http://hl7.org/fhir/R4/bundle.html\">Bundle</a>\n </td>\n <td/>\n <td>\n <div>\n <p>The result of the packaging. Servers generating packages SHALL include all the dependency resources referenced by the library that are known to the server (if include-dependencies\n is true), and all the component resources referenced by the library that are known to the server (if include-components is true). For example, a measure repository SHALL include\n all the required library resources, but would not necessarily have the ValueSet resources referenced by the measure.</p>\n </div>\n </td>\n </tr>\n </table>\n <div>\n <p>This operation is used to retrieve the contents associated with a particular library such as a quality program, including the use of the quality program as a binding parameters specification\n to identify code system and value set versions that should be used for expansion of value sets used by measures in the quality program.</p>\n </div>\n </div>"
  },
  "extension" : [
    {
      "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
      "valueCode" : "pher"
    }
  ],
  "url" : "http://hl7.org/fhir/us/ecr/OperationDefinition/operationdefinition-library-package",
  "version" : "2.1.2",
  "name" : "LibraryPackaging",
  "title" : "Library Packaging",
  "status" : "draft",
  "kind" : "operation",
  "date" : "2021-07-26T09:29:23+11:00",
  "publisher" : "HL7 International / Public Health",
  "contact" : [
    {
      "name" : "HL7 International / Public Health",
      "telecom" : [
        {
          "system" : "url",
          "value" : "http://www.hl7.org/Special/committees/pher"
        }
      ]
    }
  ],
  "description" : "Packages the contents referenced by an asset-collection library such as a quality program release or version manifest.",
  "jurisdiction" : [
    {
      "coding" : [
        {
          "system" : "urn:iso:std:iso:3166",
          "code" : "US"
        }
      ]
    }
  ],
  "code" : "package",
  "comment" : "This operation is used to retrieve the contents associated with a particular library such as a quality program, including the use of the quality program as a binding parameters specification to identify code system and value set versions that should be used for expansion of value sets used by measures in the quality program.",
  "resource" : [
    "Library"
  ],
  "system" : false,
  "type" : true,
  "instance" : true,
  "parameter" : [
    {
      "name" : "id",
      "use" : "in",
      "min" : 0,
      "max" : "1",
      "documentation" : "The logical id of the library to package. The server must know the library (e.g. it is defined explicitly in the server's libraries)",
      "type" : "string"
    },
    {
      "name" : "url",
      "use" : "in",
      "min" : 0,
      "max" : "1",
      "documentation" : "A canonical reference to a library. The server must know the library (e.g. it is defined explicitly in the server's libraries",
      "type" : "uri"
    },
    {
      "name" : "version",
      "use" : "in",
      "min" : 0,
      "max" : "1",
      "documentation" : "The version of the library to be used for packaging",
      "type" : "string"
    },
    {
      "name" : "identifier",
      "use" : "in",
      "min" : 0,
      "max" : "1",
      "documentation" : "A business identifier of the library to be packaged. The server must know the library and the identifier must resolve unambiguously to a single library on the server.",
      "type" : "string",
      "searchType" : "token"
    },
    {
      "name" : "capability",
      "use" : "in",
      "min" : 0,
      "max" : "*",
      "documentation" : "A desired capability of the resulting package. `computable` to include computable elements in packaged content, `executable` to include executable elements in packaged content, `publishable` to include publishable elements in packaged content.",
      "type" : "string"
    },
    {
      "name" : "offset",
      "use" : "in",
      "min" : 0,
      "max" : "1",
      "documentation" : "Paging support - where to start if a subset is desired (default = 0). Offset is number of records (not number of pages)",
      "type" : "integer"
    },
    {
      "name" : "count",
      "use" : "in",
      "min" : 0,
      "max" : "1",
      "documentation" : "Paging support - how many resources should be provided in a partial page view. If count = 0, the client is asking how large the package is.",
      "type" : "integer"
    },
    {
      "name" : "system-version",
      "use" : "in",
      "min" : 0,
      "max" : "*",
      "documentation" : "Specifies a version to use for a system, if the library or value set does not already specify which one to use. The format is the same as a canonical URL: [system]|[version] - e.g. http://loinc.org|2.56",
      "type" : "canonical"
    },
    {
      "name" : "check-system-version",
      "use" : "in",
      "min" : 0,
      "max" : "*",
      "documentation" : "Edge Case: Specifies a version to use for a system. If a library or value set specifies a different version, an error is returned instead of the package. The format is the same as a canonical URL: [system]|[version] - e.g. http://loinc.org|2.56",
      "type" : "canonical"
    },
    {
      "name" : "force-system-version",
      "use" : "in",
      "min" : 0,
      "max" : "*",
      "documentation" : "Edge Case: Specifies a version to use for a system. This parameter overrides any specified version in the library and value sets (and any it depends on). The format is the same as a canonical URL: [system]|[version] - e.g. http://loinc.org|2.56. Note that this has obvious safety issues, in that it may result in a value set expansion giving a different list of codes that is both wrong and unsafe, and implementers should only use this capability reluctantly. It primarily exists to deal with situations where specifications have fallen into decay as time passes. If the value is override, the version used SHALL explicitly be represented in the expansion parameters",
      "type" : "canonical"
    },
    {
      "name" : "manifest",
      "use" : "in",
      "min" : 0,
      "max" : "1",
      "documentation" : "Specifies an asset-collection library that defines version bindings for code systems referenced by the value set(s) being expanded. When specified, code systems identified as `depends-on` related artifacts in the library have the same meaning as specifying that code system version in the `system-version` parameter.",
      "type" : "canonical"
    },
    {
      "name" : "include-dependencies",
      "use" : "in",
      "min" : 0,
      "max" : "1",
      "documentation" : "Specifies whether to include known (i.e. present on the server) dependencies of the library in the resulting package, recursively (default = true)",
      "type" : "boolean"
    },
    {
      "name" : "include-components",
      "use" : "in",
      "min" : 0,
      "max" : "1",
      "documentation" : "Specifies whether to include known (i.e. present on the server) components of the library in the resulting package, recursively (default = true)",
      "type" : "boolean"
    },
    {
      "name" : "return",
      "use" : "out",
      "min" : 1,
      "max" : "1",
      "documentation" : "The result of the packaging. Servers generating packages SHALL include all the dependency resources referenced by the library that are known to the server (if include-dependencies is true), and all the component resources referenced by the library that are known to the server (if include-components is true). For example, a measure repository SHALL include all the required library resources, but would not necessarily have the ValueSet resources referenced by the measure.",
      "type" : "Bundle"
    }
  ]
}

XIG built as of ??metadata-date??. Found ??metadata-resources?? resources in ??metadata-packages?? packages.